From 35e438a62e5ff6d99be22772993124df27e49592 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Mon, 22 Feb 2021 19:08:05 +0000 Subject: [PATCH] treeview: Update the description format --- gtk/gtktreeview.c | 54 +++++++++++++++++++++++------------------------ 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c index d1396e0d8a..d8ac607770 100644 --- a/gtk/gtktreeview.c +++ b/gtk/gtktreeview.c @@ -80,20 +80,19 @@ * #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, * #GtkCellRendererText, #GtkCellRendererToggle * - * Widget that displays any object that implements the #GtkTreeModel interface. + * Widget that displays any object that implements the [iface@Gtk.TreeModel] interface. * - * Please refer to the - * [tree widget conceptual overview][TreeWidget] - * for an overview of all the objects and data types related - * to the tree widget and how they work together. + * Please refer to the [tree widget conceptual overview](section-tree-widget.html) + * for an overview of all the objects and data types related to the tree + * widget and how they work together. * - * Several different coordinate systems are exposed in the GtkTreeView API. + * ## Coordinate systems in GtkTreeView API + * + * Several different coordinate systems are exposed in the `GtkTreeView` API. * These are: * * ![](tree-view-coordinates.png) * - * Coordinate systems in GtkTreeView API: - * * - Widget coordinates: Coordinates relative to the widget (usually `widget->window`). * * - Bin window coordinates: Coordinates relative to the window that GtkTreeView renders to. @@ -104,18 +103,19 @@ * Several functions are available for converting between the different * coordinate systems. The most common translations are between widget and bin * window coordinates and between bin window and tree coordinates. For the - * former you can use gtk_tree_view_convert_widget_to_bin_window_coords() - * (and vice versa), for the latter gtk_tree_view_convert_bin_window_to_tree_coords() + * former you can use [method@Gtk.TreeView.convert_widget_to_bin_window_coords] + * (and vice versa), for the latter [method@Gtk.TreeView.convert_bin_window_to_tree_coords] * (and vice versa). * - * # GtkTreeView as GtkBuildable + * ## `GtkTreeView` as `GtkBuildable` + * + * The `GtkTreeView` implementation of the `GtkBuildable` interface accepts + * [class@Gtk.TreeViewColumn] objects as `` elements and exposes the + * internal [class@Gtk.TreeSelection] in UI definitions. * - * The GtkTreeView implementation of the GtkBuildable interface accepts - * #GtkTreeViewColumn objects as elements and exposes the internal - * #GtkTreeSelection in UI definitions. + * An example of a UI definition fragment with `GtkTreeView`: * - * An example of a UI definition fragment with GtkTreeView: - * |[ + * ```xml * * liststore1 * @@ -135,11 +135,11 @@ * * * - * ]| + * ``` * - * # CSS nodes + * ## CSS nodes * - * |[ + * ``` * treeview.view * ├── header * │ ├── button @@ -150,20 +150,20 @@ * │ * ├── [rubberband] * ╰── [dndtarget] - * ]| + * ``` * - * GtkTreeView has a main CSS node with name treeview and style class .view. - * It has a subnode with name header, which is the parent for all the column + * `GtkTreeView` has a main CSS node with name `treeview` and style class `.view`. + * It has a subnode with name `header`, which is the parent for all the column * header widgets' CSS nodes. * - * Each column header consists of a button, which among other content, has a - * child with name sort-indicator, which carries the .ascending or .descending + * Each column header consists of a `button`, which among other content, has a + * child with name `sort-indicator`, which carries the `.ascending` or `.descending` * style classes when the column header should show a sort indicator. The CSS - * is expected to provide a suitable image using the -gtk-icon-source property. + * is expected to provide a suitable image using the `-gtk-icon-source` property. * - * For rubberband selection, a subnode with name rubberband is used. + * For rubberband selection, a subnode with name `rubberband` is used. * - * For the drop target location during DND, a subnode with name dndtarget is used. + * For the drop target location during DND, a subnode with name `dndtarget` is used. */ enum -- 2.30.2